package cn.iocoder.yudao.module.pay.wallet.service;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.api.pay.wallet.enums.PayWalletBizTypeEnum;
import cn.iocoder.yudao.module.pay.wallet.dal.dataobject.PayWalletDO;
import cn.iocoder.yudao.module.pay.wallet.dal.dataobject.PayWalletTransactionDO;
import cn.iocoder.yudao.module.pay.wallet.vo.PayWalletPageReqVO;

/**
 * 钱包 Service 实现类
 *
 * @author jason
 */
public interface PayWalletService {

    /**
     * 获取钱包信息
     * <p>
     * 如果不存在，则创建钱包。由于用户注册时候不会创建钱包
     *
     * @param userId   用户编号
     * @param userType 用户类型
     */
    PayWalletDO getOrCreateWallet(Long userId, Integer userType);

    /**
     * 获取钱包信息
     *
     * @param walletId 钱包 id
     */
    PayWalletDO getWallet(Long walletId);

    /**
     * 获得用户钱包分页
     *
     * @param pageReqVO 分页查询
     * @return 用户钱包分页
     */
    PageResult<PayWalletDO> getWalletPage(PayWalletPageReqVO pageReqVO);

    /**
     * 钱包订单支付
     *
     * @param walletId   钱包编号
     * @param payNo 统一支付单号
     * @param price      金额
     */
    PayWalletTransactionDO orderPay(Long walletId, String payNo, Integer price);

    /**
     * 钱包订单支付退款
     *
     * @param refundNo 统一退款单号
     * @param refundPrice 退款金额
     * @param reason      退款原因
     */
    PayWalletTransactionDO orderRefund(String refundNo, Integer refundPrice, String reason);

    /**
     * 钱包订单转账
     *
     * @param transferNo 统一转账单号
     * @param price 金额
     * @param subject 主题
     */
    PayWalletTransactionDO orderTransfer(String transferNo, Integer price, String subject);

    /**
     * 扣减钱包余额。
     * 允许扣减出负数来，比如：用户确认收货后结算了佣金，然后申请了退款，在退款未确认之前把佣金提现用了，之后确认退款将可扣减成负数。
     *
     * @param walletId 钱包编号
     * @param bizId    业务关联编号
     * @param bizType  业务关联分类
     * @param price    扣减金额
     * @return 钱包流水
     */
    PayWalletTransactionDO reduceWalletBalance(Long walletId, String bizId, PayWalletBizTypeEnum bizType, Integer price);

    /**
     * 增加钱包余额
     *
     * @param walletId 钱包编号
     * @param bizId    业务关联编号
     * @param bizType  业务关联分类
     * @param price    增加金额
     * @return 钱包流水
     */
    PayWalletTransactionDO addWalletBalance(Long walletId, String bizId, PayWalletBizTypeEnum bizType, Integer price);

    /**
     * 冻结钱包部分余额
     *
     * @param id    钱包编号
     * @param price 冻结金额
     */
    void freezePrice(Long id, Integer price);

    /**
     * 解冻钱包余额
     *
     * @param id    钱包编号
     * @param price 解冻金额
     */
    void unfreezePrice(Long id, Integer price);

    /**
     * 提现成功，重置申请中的金额
     *
     * @param userId 用户编号
     * @param userType 用户类型
     * @param applyPrice 申请金额
     */
    void resetMoneyCashing(Long userId, Integer userType, Integer applyPrice);

}
